Release 10.1A: OpenEdge Development:
Progress Dynamics Managers API Reference

Overview

The Session Manager controls the starting and stopping of application components in a distributed environment. It passes client requests to execute server-side business logic to the appropriate procedures, wherever they are running. It also manages client context for the stateless execution of all server-side components. It also supports the following application services:

Context management.
Persistent procedure management.
Session property management.
Error and message handling.
Online help.

After all the necessary connections have been established by the Connection Manager, the Session Manager starts to handle the actual running of the session. It is responsible for coordinating the activities of the various other Managers used in the session.

In a distributed environment, the Session Manager is started on both the client and server sides. There is a wrapper program for each side that sets the global variable, server-side, to either YES for the server-side version or NO for the client-side version. Both programs then include the main code of the manager from the af\app\afsesmngrp.i include file. The differences in how the manager operates on each side are triggered by checking the value of the server-side variable.

The Session Manager’s handle is stored in the global shared variable, gshSessionManager.

Table 10–1 shows the files that contain the Session Manager’s code.

Table 10–1: Session Manager files

Type	Path
Client-side wrapper	af\sup2\afsesclntp.p
Server-side wrapper	af\app\afsessrvrp.p
Main code	af\app\afsesmngrp.i
Included files	adecomm\appsrvtt.i adecomm\appserv.i adm2\calltables.i adm2\callttparam.i adm2\globals.i adm2\ttaction.i adm2\tttoolbar.i af\app\afsesgetglcp.i af\app\afttglobalctrl.i af\app\afttpersist.i af\app\afttprofiledata.i af\app\afttsecurityctrl.i af\app\aftttranslate.i af\app\aftttranslation.i af\app\gsttenmn.i af\app\logintt.i af\sup\windows.i af\sup2\afcheckerr.i af\sup2\aferrortxt.i af\sup2\aflaunch.i af\sup2\afttcombo.i ry\app\rydefrescd.i

For more information on this Manager, see the chapter on using the Progress Dynamics Managers in OpenEdge Development: Progress Dynamics Advanced Development .